home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
pc_board
/
addpcb20.zip
/
ADDPCB.DOC
next >
Wrap
Text File
|
1992-12-01
|
22KB
|
592 lines
███████┐ ████████┐ ████████┐ ███████┐ ███████┐ ████████┐
██┌──██│ └██┌──██│ └██┌──██│ ██┌──██│ ██┌────┘ └██┌──██│
███████│ ██│ ██│ ██│ ██│ ███████│ ██│ ███████│
██┌──██│ ██│ ██│ ██│ ██│ ██┌────┘ ██│ ██┌──██│
██│ ██│ ████████│ ████████│ ██│ ███████┐ ████████│
└─┘ └─┘ └───────┘ └───────┘ └─┘ └──────┘ └───────┘
ADDPCB Version 2.0
December 1, 1992
For PCBoard Systems
Copyright (C) 1992 by Bob Aune - All Rights Reserved.
Latest Versions and Support
Available at the
OnLine Exchange BBS
(714) 870-4614
2400-14,400 Baud V.32bis/HST
Are you tired of typing in the descriptions every time you add files
to your board? With this program, typing in descriptions by hand will
be over.
This time-saving program aids the PCB Sysop by importing files with
their descriptions downloaded from other PCBoard BBS's to your PCBoard
BBS automatically.
Table of Contents
─────────────────
What is ADDPCB . . . . . . . . . . . . . . . . . . . . . . . . . 1
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Possible Uses . . . . . . . . . . . . . . . . . . . . . . . . . 3
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Starting ADDPCB . . . . . . . . . . . . . . . . . . . . . . . . 4
Command Line Options . . . . . . . . . . . . . . . . . . . . . . 5
Operating ADDPCB . . . . . . . . . . . . . . . . . . . . . . . . 6
Configuration (Fields) . . . . . . . . . . . . . . . . . . . . . 6
Configuration (Options) . . . . . . . . . . . . . . . . . . . . 7
External Testing . . . . . . . . . . . . . . . . . . . . . . . . 8
FILE_ID.DIZ Support . . . . . . . . . . . . . . . . . . . . . . 8
Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Registration Information . . . . . . . . . . . . . . . . . . . .10
Legal Stuff . . . . . . . . . . . . . . . . . . . . . . . . . .11
ADDPCB User Documentation Page 1
──────────────────────────────────────────────────────────────────────
WHAT IS ADDPCB
──────────────
ADDPCB is a program that import files with their descriptions to your
board painlessly. ADDPCB works off of 4 fields in the configuration as
shown on the main screen. They are:
/ FILE - Containing descriptions (field 1)
FROM
\ DIRECTORY - Location of files to import (field 2)
/ FILE - Descriptions get added to (field 3)
TO
\ DIRECTORY - Location to import files (field 4)
ADDPCB looks for files in the directory (field 2), it might be your
download dir., misc. dir., or directory of files to be tested. Next
it will search for the descriptions in a text file (field 1), The text
file could be a 'allfiles' list or a capture file. If the description
is found, then the program will optionally test the file by calling an
external batch file and if the file passes the test, then will process
the description and the file into your system.
This program can be run from a batch file or on the command line. It's
a ideal program to use after a download session as it will import the
new files into your PCBoard system along with their descriptions. The
automatic feature enables it to run in the unattended mode such as in
events and with unattended communication programs.
ADDPCB User Documentation Page 2
──────────────────────────────────────────────────────────────────────
FEATURES
────────
- Complete user interface with a built in configuration editor.
- Several configuration files can exist for importing files to
different conferences or directories.
- Can test whole directories of files without moving their location
or effecting the descriptions.
- Can be used in your event, comm program batch file, or on the
command line.
- Imports description from any ZIP archive containg FILE_ID.DIZ.
- Duplicate description and file detection with options.
- Optional test each file as it is imported to your board.
- Description Modification Options such as:
- First letter capitalized.
- All letters upper case.
- All letters lower case.
- Add 'Uploaded by (your name)' to the bottom of the description.
- Option to re-date the the file and the date in the description to
today's date.
- Can be used under a network or multitasker.
ADDPCB User Documentation Page 3
──────────────────────────────────────────────────────────────────────
POSSIBLE USES
─────────────
Import files from another PCBoard BBS to your BBS.
┌────────────────────────────────────────────────────────────────────┐
│ 1) Call your favorite BBS. │
│ 2) Turn your Communication program CAPTURE on. │
│ 3) Do a (Z)ippy search or search (N)ew files and the descriptions │
│ will be captured to the capture file. │
│ 4) Download the files. │
│ 5) Run ADDPCB. │
└────────────────────────────────────────────────────────────────────┘
Files placed in a hold/misc. directory for missing descriptions.
┌────────────────────────────────────────────────────────────────────┐
│ 1) Download the ALLFILES list from a few boards. │
│ 2) Run ADDPCB. │
│ 3) Watch how many of the descriptions can be located. │
│ 4) If still have files without descriptions, then get another │
│ list and run ADDPCB again. │
└────────────────────────────────────────────────────────────────────┘
Files on the board already but needs testing only.
┌────────────────────────────────────────────────────────────────────┐
│ 1) Use your board's file listing. │
│ 2) Change field 4 to the same as field 2. This will then not move │
│ the files. │
│ 3) Change field 3 to the same as field 1 and go into 'Options' and │
│ set to KEEP the original description and run ADDPCB. │
│ 4) Run ADDPCB. │
└────────────────────────────────────────────────────────────────────┘
Files on the board already but you would rather have the description
from FILE_ID.DIZ (if it exist).
┌────────────────────────────────────────────────────────────────────┐
│ 1) Use your board's file listing. │
│ 2) Change field 4 to the same as field 2. This will then not move │
│ the files. │
│ 3) Change field 3 to the same as field 1 and go into 'Options' and │
│ set to OVERWRITE the original description and run ADDPCB. │
│ 4) Run ADDPCB. │
└────────────────────────────────────────────────────────────────────┘
Files on the board already but you would like an easy way to convert
the description to your likeing.
┌────────────────────────────────────────────────────────────────────┐
│ 1) Use your board's file listing. │
│ 2) Change field 4 to the same as field 2. This will then not move │
│ the files. │
│ 3) Change field 3 to the same as field 1 and go into 'Options' and │
│ set to OVERWRITE the original description and run ADDPCB. │
│ 4) Change one or more of the Description Modification Options. │
│ 5) Run ADDPCB. │
└────────────────────────────────────────────────────────────────────┘
ADDPCB User Documentation Page 4
──────────────────────────────────────────────────────────────────────
INSTALLATION
────────────
The installation is very easy. Put the file ADDPCB.EXE in a directory
of your choice. Preferably your utility directory or a directory in
your path. The configuration file will be created the first time you
run the program.
STARTING ADDPCB
──────────────-
Type ADDPCB and the name of the configuration file you wish to use. If
the configuration file does'nt exist, then one will be created. The
name of the configuration file/s can be any name you choose.
Examples:
ADDPCB ADDPCB.CFG
ADDPCB CONF0.CFG
ADDPCB CONF1.CFG
ADDPCB IMPORT.CN0
ADDPCB IMPORT.CN1
The configuration file is placed in the same directory that contains
ADDPCB.EXE regardless of the directory you called the program from. If
you do not wish to have the configuration file in the same directory,
then you must specify the full path\name of the configuration file on
the command line or in a batch file.
EXAMPLE: ADDPCB C:\PCB\UTILS\ADDPCB.CFG
ADDPCB User Documentation Page 5
──────────────────────────────────────────────────────────────────────
COMMAND LINE OPTIONS
────────────────────
ADDPCB has 3 switches that can be used. These switches are optional.
The command format and switch parameters are described below. A quick
review of the command switches is available by typing ADDPCB by itself.
Automatic mode
/A or /a Used for unattended operation. The configuration file
you specified must exist and the fields must be correct
else the /A option will not function.
Put ADDPCB CONFIG.CFG /A in your batch file and it will
run without operator intervention.
Registering your copy
/R or /r Used for registering your copy of ADDPCB. Once it has
been registered, you will receive a key number. Type
ADDPCB /R and you will be prompted for your name and
number. The program will brand your copy of ADDPCB.EXE.
If you are registered and upgrading to a later version
of ADDPCB, then you must use this switch using the same
number.
Monochrome mode on a color monitor
/M or /m Not that you will ever want to use this feature, but it
is there.
Examples:
ADDPCB IMPORT.CN0 /A
ADDPCB IMPORT.CN1 /AM
ADDPCB /R
ADDPCB ADDPCB.CFG /RM
ADDPCB CONF0.CFG
ADDPCB CONF1.CFG
ADDPCB User Documentation Page 6
──────────────────────────────────────────────────────────────────────
OPERATING ADDPCB
────────────────
The program is straight foward and should be self expanatory. Although
I'm making every attempt to explain the program and its features. If
you hav'nt already ran the program, now might be a good time to do so
and get a feel for the program. At the bottom of the screen there are
four selection items. They are 'Exit', 'Edit Fields', 'Options', and
'Start Process'. Before the 'Start Process' can be selected, all of
the 'Fields' must contain valid path/names and the files or directory
must exist (except the last one 'External Test' which is optional').
If any of the TO fields (fields 3 and 4) does'nt exist, then you will
be be asked if you would the directory or file created for you.
CONFIGURATION (FIELDS)
──────────────────────
NOTE:
If a field is flashing, that is indicating that the path/name of the
file or the directory is not valid or does not exist.
DESCRIPTION FILE TO BE SEARCHED: C:\DL\ALLFILES.LST
This is the path/name of the description file. It can be a ALLFILES
list or a CAPTURE list or a DIRxx listing from your own board.
DIRECTORY OF FILES TO BE PROCESSED: C:\DOWNLOAD
This may be the directory that is holding your downloaded files or a
directory holding misc. files without descriptions or a directory of
files you want to test.
DESCRIPTION FILE YOU WANT TO UPDATE: C:\PCB\MAIN\UPDIR
This is the path/name of the destination file that new descriptions
are written to. If the path\name of the file does not exist, then you
will be asked if you want the file created for you.
DIRECTORY WHERE THE FILES GET MOVED TO: C:\UPDIR
This is the directory that the files gets moved into. If you do not
wish to have the files moved, then enter the same directory as field 2
If the path\name of the directory does'nt exist then you will be asked
if you want the directory created for you.
EXTERNAL TEST PROGRAM: C:\PCB\UTIL\TEST.BAT
Put in the path/name of the batch file calling your test program. If
you don't want to test the files as they are imported, then leave this
field blank.
After the last field has been entered, then you will be taken back to
the main choices. Press the <left> or <right> arrow key to select and
press the <ENTER> key.
ADDPCB User Documentation Page 7
──────────────────────────────────────────────────────────────────────
CONFIGURATION (OPTIONS)
───────────────────────
CAPITALIZE THE FIRST LETTER.
Although most descriptions will have the first letter capitalize.
There might be times when it is not and this feature will correct it.
This feature can also be used if the description is in all upper case
and you use the option to convert to all lower case and this option to
capitalize the first letter.
ALL LETERS UPPER CASE
Convert the description imported to all upper case.
ALL LETTERS LOWER CASE
Convert the description imported to all lower case.
UPLOADED BY:
Choose (Y)es and you'll be prompted for your name or 'Sysop' then when
the description is imported it will contain 'Uploaded by (your name)'
on the last line of the description.
SET FILE DATE TO TODAY'S DATE:
Setting this option to (Y)es will change the file date to today's date
and will change the date in the description to today's date.
NOTE:
These next 3 options work together and only one of them can be set to
(Y)es at one time.
PROMPT IF DUPLICATE IS DETECTED
If this option is set to (Y)es and a duplicate description is found,
then you will be asked if you want to keep the one thats already there
or to use the new one or to keep both. If a duplicate file is found
then you have the choice of keeping the one that's already there or to
overwrite with the new one. If you have this option set to (Y)es and
are running in the unattended mode, then any duplicate descriptions or
files found will be kept and the new file will not be moved and will
remain where it was before.
DON'T PROMPT - OVERWRITE
This option can be used in either the unattended or in the attended
mode. If a duplicate description is detected, then the new description
will be appended to bottom of the description file specified in field
3 and the description that was there before will be deleted. The new
file will overwrite the one that was their before.
DON'T PROMPT - KEEP
This option can be used in either the unattended or in the attended
mode. If a duplicate description is detected, then the original will
stay and the new one will not be added. The original file will also
stay and the new file will remain where it was before.
ADDPCB User Documentation Page 8
──────────────────────────────────────────────────────────────────────
EXTERNAL TESTING
───────────────-
If you chose to have ADDPCB test the files, then you must specify the
name of your batch file in the field 'EXTERNAL TEST PROGRAM'.
Your upload tester MUST be configured to move any failed files to a
reject/offline/bad/hold directory. This will insure that ADDPCB will
detect any failed files. If ADDPCB sees that a file failed, then all
furture processing of that file will end and ADDPCB will move on to
the next file. The description will not be added. If a file passed
the testing, then the description and file will be processed in.
FILE_ID.DIZ SUPPORT
──────────────────-
ADDPCB will detect any .ZIP archive containing the FILE_ID.DIZ file
and will get the description from the FILE_ID.DIZ file to import. This
feature depends on a copy of PKUNZIP.EXE being in the path.
ADDPCB User Documentation Page 9
──────────────────────────────────────────────────────────────────────
Support
──────-
Comments and suggestions about ADDPCB are welcomed. Please notify me
if you discover a bug, so that it can be prompty corrected.
OnLine Exchange at (714) 870-4614. <<< Home of ADDPCB
I can alse be reached on: RIME - Sysops Conf. Bob Aune
Ilink - Sysops Conf. " "
Metrolink - PCBHints Conf. " "
ADDPCB User Documentation Page 10
──────────────────────────────────────────────────────────────────────
Registering ADDPCB
──────────────────
This program is distributed as SHAREWARE. This enables users to eval-
uate software for a 30 day trial period. If you find this program
useful, please register it. Otherwise, if the user finds this program
is not of sufficient merit to warrant purchase through registration
then the program must be removed from their computer.
This concept enables quality software to be distributed at a reason-
able cost. I do greatly appreciate all users that care enough to reg-
ister. I try to provide the best possible software for the supporting
users.
You may register ADDPCB by mailing in the enclosed REGISTER.FRM along
with a check or money order in the amount of $10.00.
Send registration to:
Bob Aune
2404 E. Nutwood Ave.
Fullerton, CA. 92631
The registration charge is a one time fee that entitles you to:
* All future versions.
* Unlimited technical support.
* Access to the OnLine Exchange BBS.
* Removal of the "Please Register" message.
* A personalized number via US Mail and on the support BBS.
This program may either be obtained from normal Shareware sources or
from the OnLine Exchange BBS (714) 870-4614.
ADDPCB User Documentation Page 11
──────────────────────────────────────────────────────────────────────
Legal Stuff
───────────
Disclaimer
I hereby disclaim all warranties relating to this product, whether
express or implied including without limitation any implied warranties
of merchantability or fitness for a particular purpose. I cannot and
will not be liable for any special, incidental, consequential,indirect
or similar damages due to loss of data or any other reason. In no
event shall the liability for any damages ever exceed the price paid
for the license to use software, regardless of the form and/or extent
of the claim. The user of this program bears all risk as to the
quality and performance of the software.
File Contents
-------------
ADDPCB.DOC - The Document that you're reading now.
ADDPCB.EXE - The Program.
TEST.BAT - Sample BATCH file to call your favorite upload tester.
FILE_ID.DIZ - Description of this program. Used by PCBoard for adding
the authors version of the description to the board
automatically.
REGISTER.FRM - Mail-in registration form.
This archive has been zipped using PKWARE authenticity verification
system. If there are any files in this archive that do not have the
verification tag beside them (-AV), it indicates that the archive has
been tampered with and is not in the original form. If this is the
case, please call the support BBS for a valid copy.
Bob Aune
The OnLine Exchange
(714) 870-4614 2400-14,400 Baud V.32bis/HST